XML Plan

概述

GSD 系统的结构化执行计划格式，使用 XML 标签定义任务，每个标签有明确职责，形成机器可读、人类可理解的原子执行单元。

关键内容

1. XML 结构： xml <task type="auto|manual"> <!-- auto: Claude自动执行, manual: 需要人工干预 --> <n>创建用户登录 API 端点</n> <files>src/app/api/auth/login/route.ts</files> <action> 使用 jose 处理 JWT（禁用 jsonwebtoken）。 从 users 表验证凭证，密码用 bcrypt 比对。 成功后设置 httpOnly cookie，不在响应体中返回 token。 失败统一返回 401，不透露具体原因。 </action> <verify> curl -X POST localhost:3000/api/auth/login \ -d '{"email":"t@t.com","password":"correct"}' | grep -E "200|Set-Cookie" </verify> <done>有效凭证返回 200 + Set-Cookie；无效凭证返回 401</done> </task>

2. 任务类型：

3. auto：Claude 自动执行的任务

4. manual：需要人工干预的任务（例如：复杂的设计决策、代码审查等）

5. 标签职责：

6. 标签职责：

7. <n>：任务名称（也是 git commit 名称）
8. <files>：涉及文件路径（消除猜测）
9. <action>：具体执行指令
10. <verify>：验证命令（Claude 会真正运行）
11. <done>：完成判断标准

12. <depends_on>：依赖关系（用于 DAG 分析）

13. 原子性原则：

14. 每个 PLAN 文件包含 2-3 个任务
15. 可在干净 200k 上下文窗口内完成

16. 超过 150 个文件操作应拆分

17. 文件命名：

18. {phase}-{plan}-PLAN.md

19. 例：02-01-PLAN.md（第 2 阶段第 1 个计划）

20. 验证维度（plan-checker）：

21. 需求覆盖检查
22. 依赖合理性
23. 验证命令可执行性
24. 完成标准清晰度

来源

• 01-overview-context-rot — Context Rot 与上下文工程
• 03-core-workflow — 核心工作流

相关

• GSD — part_of
• GSD Commands — uses
• GSD Planning Directory — part_of